
==========
Ganz kurz:
==========

Zip-Archiv in ein (leeres) Verzeichnis kopieren,
dort entpacken: "unzip VRWeather" (legt Unterverzeichnisse
automatisch an).

Zum Starten "install.exe" aufrufen.

(1) EINFACH LOSLEGEN:

  "VRWeather.exe" starten, die erforderliche Konfiguration
  (Erstellen einer Weather.cnf) wird im Dialog erledigt, falls
  install.exe vergessen wurde.

  Alles weitere ergibt sich (hoffentlich).

  Wenn nicht, lesen unter "Allgemeines" ein paar Details.

(2) Konfig-Datei manuell erstellen:

   Die zentrale Konfigurations-Datei heit Weather.cnf und kann mit jedem 
   beliebigen ASCII-Editor (z.B. ae.exe) erstellt / bearbeitet werden.

   Sie mu etwa diesen Inhalt haben (s. auch Datei "ProtoD.cnf"):

	Ŀ
	PLACE=Mein Wohnort	; benutzereigene Bezeichnung, 		
				; sonst <auto> = Name der DWD-Mestation
	CITY=Bdelsdorf	; wahlweise Ortsname gem. City-List	
				; sonst diese Zeile entfernen 		
	LATITUDE=54.0833	; wenn kein CITY -> dann erforderlich!	
	LONGITUDE=12.1333	; wenn kein CITY -> dann erforderlich!	
									
	Language=DE		; oder EN oder ES			
									
	ICONSET=3		; oder 1 oder 2 oder 4			
	LOG=1			; oder 0 (kein Log)			
									
	OPTAHEAD=1		; 0=kein 1=fr heute 3=fr alle 3 Tage	
	CLOCK=1		; oder 0 (keine Uhrzeit-Anzeige)	
									
	


   Wichtig sind die Parameter Latitude und Longitude.
   City und Place mssen nicht angegeben werden. Wenn CITY nicht in der
   City-Liste (Germany.cls) enthalten ist, funktioniert es trotzdem,
   solange Latitude und Longitude korrekt angegeben sind.


============
Allgemeines:
============
VRWeather.exe ist eine GUI-Version von Frank Wochat's WPWeather.cmd,
mit einigen kleinen Erweiterungen:

- Wetterdaten zustzlich:
  > Luftdruck
  > Sonnenscheindauer
  > Windstrke von Ben

- Wetterdaten fr "Heute" einer bestimmten Stunde anzeigen

- Wetterdaten fr einen beliebigen Tag in der Zukunft anzeigen

- Log-Datei-Auswertung mit Darstellung der Vorhersage-
  Genauigkeit von "Gestern" fr "Heute".

- Ausserdem ist eine City-List beigefgt, die die Geo-Koordinaten
  fr die 130 grten Stdte Deutschlands enthlt.
  Ausserdem einige weitere Lnder.

VRWeather heit so, weil es mit Vx-Rexx erstellt wurde.

=============
INSTALLATION:
=============

(1) Das Zip-Archiv in ein neu angelegtes Verzeichnis entpacken.
    Beim Entpacken drauf achten, dass Unterverzeichnisse automatisch erstellt werden.
    Dafr z.B. diesen Befehl verwenden:
    unzip vrweather.zip

(2) VRWeather starten
    Als erstes erscheint ein Dialog: "Keine Config-Datei gefunden"
    OK klicken, daraufhin ffnet sich ein Dialog zum Erstellen
    der Config-Datei weather.cnf
    Die Hinweise sollten selbsterklrend sein.

    Nach erfolgter Erfassung der CITY und ggf. der Koordinaten SAVE klicken.

    Danach ist das Programm betriebsbereit. Es werden die momentan aktuellen
    Wetterdaten fr heute, morgen und bermorgen angezeigt.

    Weitere Lnder mit Stdten und ihren Koordinaten installieren:
    --------------
    Die Website www.simplemaps.com bietet fr alle Lnder der Welt Listen
    mit den wichtigsten Stdten und ihren Koordinaten, u.a. im CSV-Format.
    Die gewnschte Liste downloaden, ins VRWeather-Verzeichnis kopieren,
    dann mit dem hier beigefgten Rexx-Script BuildCLS.cmd installieren:
    Aufruf: BuildCLS <land>.csv

    Bitte zu beachten: Nicht alle Stdte in diesen Listen enthalten gltige
    Koordinaten, in dem Sinne dass sie nicht von DWD-Wetterstationen bedient
    werden. Das betrifft vor allem auer-europische Lnder.


=============
ANWENDUNG:
=============

    Ein Klick auf den "aktualisieren"-Button holt die Wetterdaten erneut.

    * Kiosk-Modus:
    Um das Aktualisieren zu automatisieren, kann in der nebenstehenden
    Auswahlbox ein Interval ausgewhlt werden, z.B. "2" fr alle 2 Stunden.
    Das kleinst-mgliche Interval ist 0.1 (also 6 Minuten). In diesem Fall
    werden die Wetterdaten alle 6 Minuten erneut abgefragt, ausser4dem die
    angefragte Stunde um 1 erhht.

    * Einen anderen Ort auswhlen:
    In das Eingabefeld links oben einen beliebigen Ortsnamen eintippen und
    auf den Doppelpfeil (rechts daneben) klicken.
    Falls dann der Text "not in list" ausgegeben wird, mssen die Koordinaten
    (LATITUDE und LONGITUDE) manuell ermittelt und in die Datei Weather.cnf
    eingetragen werden. Google Maps (maps.google.com) kann dabei behilflich sein.

    * Einen anderen Ort dauerhaft in die City-List eintragen:
    Maus ber der DropDown-Box (links oben) positionieren, dann KontextMen 
    aufrufen (rechte Maustaste). Klick auf "Insert <neue city> in city-list".
    Dabei werden die Koordinaten verwendet, die aktuell in der weather.cnf stehen.

    * Das Farbschema anpassen:
    Die Hintergrundfarben der jeweiligen Fenster knnen leicht modifiziert und
    an den eigenen Geschmack angepat werden:
    OS/2-Farbpalette ffnen, beliebige Farbe auswhlen und auf das zu ndernde
    Programm-Objekt ziehen.

    ==> Fr weitere Funktionen das Kontext-Men aufrufen (rechte Maustaste auf
    einem freien Bereich des Programmfensters klicken).

================
TROUBLESHOOTING:
================
Wenn irgendwas schiefluft (Programm-Absturz, Wetterdaten "N/A" oder nullen) ist
in aller Regel eine der beiden mglichen Ursachen schuld:
(1) Keine Internetverbindung.
(2) Keine gltigen Koordinaten in der Konfig-Datei (weather.cnf).
    Eine CITY oder PLACE mssen nicht zwingend angegeben werden.
    Entscheidend ist immer der korrekte Inhalt der Parameter 
    LATITUDE=xx.xxxx und LONGITUDE=yy.yyyy
    (Lngengrad, Breitengrad)


===============
und sonst noch:
===============

Danke an Frank Wochatz fr seine "Wetter-Engine" in gut strukturiertem Rexx-Code
und seine Erlaubnis, sie zu nutzen!

Kontakt:
	Lutz.Wagner@hamburg-email.de


